home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / serial / callback.001 / callback~ / callback / examples / callback.setup next >
Text File  |  1996-08-02  |  9KB  |  279 lines
  1. ############################################################################
  2. #   This file is part of the ICCE callback and dial-in monitoring system
  3. #   Copyright (c) 1994--1996, ICCE, State University of Groningen.
  4. #
  5. #   This file demonstrates the setup for the callback mode of cb.
  6.  
  7.  
  8. ############################################################################
  9. #   The callback programs look for this file in the following order:
  10. #    1. /etc/callback.setup
  11. #    2. /usr/etc/callback.setup
  12. #    3. /usr/local/etc/callback.setup
  13. #   As soon as one of these files is found, further searching stops.
  14.  
  15.  
  16. #############################################################################
  17. #   The callback-mode setupfile consists of three sections:
  18. #   A general section in which directories etc. are determined
  19. #   A section where callback-destinations are defined
  20. #   A section where users are defined.
  21. #
  22. #   These three sections must all be present, and must apppear in this order.
  23.  
  24.  
  25. #   First of all, determine the mode you want to use. In this file it's
  26. #   the callback mode. 
  27. #   A mode MUST be specified:
  28.  
  29. mode:    callback
  30.  
  31.  
  32. #   Next, specify the default modemline and possible other modem lines to use.
  33. #   If you have a single modem, set the default to this line.
  34. #   Otherwise select a particular modemline for your default, and name the 
  35. #   other lines next.
  36. #   Whenever cb is called without a speficied line the default is used.
  37. #   At least a default line MUST be specified
  38.  
  39. line: ttyS2 ttyS1
  40.  
  41.  
  42.  
  43. #   The default path where callback will find its mgetty-configuration molds.
  44. #   The default is BASE_PATH from the file configure.h
  45.  
  46. path: /conf/callback
  47.  
  48.  
  49.  
  50. #   The log-file, on which messages from cb and cblogin are written.
  51. #   By default:
  52.  
  53. logfile: /var/adm/callback.log
  54.  
  55.  
  56. #   The dial-logfile, on which times and destinations of dial-out attempts
  57. #   are written. The format of the information written on the dial-logfile
  58. #   is given by the following examples:
  59. #
  60. # Sun Jul 23 23:20:00 1995
  61. # calling Knarfix at 12345678 (cb V 4.10)
  62. # Sun Jul 23 23:40:21 1995
  63. # calling Phaedrix at 1234567 (login V 4.10)
  64. #
  65. #   By default, dial-logging is done to /dev/null:
  66.  
  67. # diallogfile: /dev/null
  68.  
  69.  
  70. #   The panic logfile, used if the logfile somehow can't be opened. 
  71. #   By default:
  72.  
  73. paniclog:  /dev/console
  74.  
  75.  
  76.  
  77. #   The verbosity of the logging: select between on, off, or default.
  78. #    off:        only logging of grammatical errors in the setup-file,
  79. #    default:    errors and warnings are logged
  80. #    on:        errors, warnings and some process-monitoring is logged
  81. #    max:        errors, warnings and extensive process-monitoring is logged
  82. #   By default:
  83.  
  84. log:    default
  85.  
  86.  
  87. #   mgetty itself expects its files in a certain directory.
  88. #   By default (as used by the mgetty+sendfax software):
  89.  
  90. mgettyconfig: /usr/local/etc/mgetty+sendfax/mgetty.config
  91.  
  92.  
  93. #   The mgetty-process listening to a particular modem-line will be reached
  94. #   via a symbolic link. E.g., modem.ttyS1.
  95. #   The part WITHOUT the line-extension may be specified here. The callback
  96. #   software will add the '.<line>' suffix, coming up with something like
  97. #   /sbin/modem.ttyS2
  98. #   By default:
  99.  
  100. modemgetty: /sbin/modem
  101.  
  102.  
  103.  
  104. #   The email-address is used in cblogin messages if set.
  105. #   By default: "root"
  106. #   A commented-out example:
  107.  
  108. #email:    you@your.computer
  109.  
  110.  
  111.  
  112. #   The login program. This program is used to overlay cblogin whenever a 
  113. #   user is validated for callback.
  114. #   By default:
  115.  
  116. login:    /bin/login
  117.  
  118.  
  119.  
  120. #   The number of times callbacks are retried. After trying in vain for 
  121. #   this number of times to connect with a particular phonemumber,
  122. #   callback stops trying to call it, and returns to its default (wait) state.
  123. #   By default:
  124.  
  125. retry: 3
  126.  
  127.  
  128.  
  129. #   The number of seconds callbacks are retried. After trying in vain for 
  130. #   this number of seconds to connect with a particular phonemumber,
  131. #   callback stops trying to call it, and returns to its default (wait) state.
  132. #   By default:
  133.  
  134. maxtime: 300
  135.  
  136.  
  137.  
  138. #   There are two ways to force cb to call a remote connection:
  139. #   The short form is:        cb User Destination
  140. #   The extensive form is:  cb call User Destination.
  141. #   If you want to use 'cb call User Destination' rather than
  142. #   'cb User Destination' uncomment 'call' below.
  143. #   By default the short form is used.
  144.  
  145. #call
  146.  
  147.  
  148.  
  149. #   If you WANT phonenumbers to appear in the 'cb list' command, then
  150. #   uncomment the 'phonenumbers' entry.
  151. #   By default, numbers are NOT shown.
  152.  
  153. #phonenumbers
  154.  
  155.  
  156.  
  157. #   If you WANT extra-destinations to appear in the list of destinations
  158. #   presented to the users of callback, uncomment the 'extra' entry.
  159. #   By default, the extra destinations are not displayed. The 'cb list' command
  160. #   will always display all destinations, regardless of the usage of 'extra' in
  161. #   this file.
  162.  
  163. #extra
  164.  
  165.  
  166.  
  167. #   If you WANT direct-destinations to appear in the list of destinations
  168. #   presented to the users of callback, uncomment the 'direct' entry.
  169. #   By default, the direct destinations are not displayed. The 'cb list' 
  170. #   command will always display all destinations, regardless of the usage 
  171. #   of 'direct' in this file.
  172.  
  173. #direct
  174.  
  175.  
  176.  
  177. #   If you DON'T normal destinations to appear in the list of destinations
  178. #   presented to the users of callback, uncomment the 'nodestinations' entry.
  179. #   By default, the normal destinations are not displayed. The 'cb list' 
  180. #   command will always display all destinations, regardless of the usage
  181. #   of 'direct' in this file.
  182.  
  183. #nodestinations
  184.  
  185.  
  186.  
  187. #############################################################################
  188. #   The next section contains destinations. These are the computers that
  189. #   may be used for callback.
  190. #
  191. #   Instead of a phonenumber, the entries
  192. #    direct
  193. #   and
  194. #    extra
  195. #   can also be used.
  196. #
  197. #   'Direct' allows the entry into the computer running callback, without
  198. #   being called back.
  199. #
  200. #   'Extra' allows the callback to whatever phonenumber. The particular
  201. #   phonenumber is requested at initial login-time.
  202. #
  203. #   Every destination belongs to a group. Below, at the users section, users
  204. #   are associated with groups, rather than destinations.
  205. #   The groupname defines a set of destinations that may be requested by the
  206. #   particular user.
  207. #   The same destination can be used for multiple groups, but, in that case,
  208. #   no user can be part of both groups.
  209. #
  210. #   The destinations start with the 'destinations:' keyword, to be followed
  211. #   by as many destinations are required.
  212. #
  213. #   A destination is formed according to the following syntax:
  214. #
  215. #   group : destinationname MODE
  216. #
  217. #    MODE is either:
  218. #        extra                (extra-callback destination)
  219. #        direct                (for direct logins)
  220. #        <phonenumber> [using <filename>]    (number plus optional file)
  221. #
  222. #   A phonenumber may start with a *, and consists apart from that of digits
  223. #   and comma's: comma's indicate delays on Hayes-compatible modems.
  224. #
  225. #   A filename is the path to a special configuration file which may be
  226. #   used with the particular destination.
  227. #
  228. #   Some examples:
  229.  
  230. destinations:
  231.  
  232. d1:    knarfix        123456
  233. dest2:    phaedrix    789012
  234.  
  235. spec:    lunatix        0712396    using    /conf/callback/callback.2400.ttyS2
  236.  
  237. local:    xinix        1234
  238. local:    bambix        5678
  239.  
  240. ed:    open        direct
  241. sm:    its-me        extra
  242.  
  243. #   So, the groups d1, dest2, spec, local, ed and sm are defined. For
  244. #   each group one or more destinations to be called back are possible,
  245. #   e.g., 'knarfix' is the destination for group d1; the group 'local'
  246. #   has two destinations.
  247. #   The phonenumber to reach the destinations is given too: e.g., 123456 to
  248. #   reach knarfix. 
  249. #   Note the group 'ed': when the destination 'open' is requested, direct
  250. #   entry is granted (no callback, but a username/password must still be
  251. #   provided.
  252. #   Also note the group 'sm': when the destination 'its-me' is requested, a
  253. #   phone number can be requested which will thereupon be the number called
  254. #   back.
  255.  
  256.  
  257. ###########################################################################
  258. #   The final section defines the users.
  259. #   The usersection starts with the
  260. #    users:
  261. #   keyword.
  262. #   Users are granted callback facilities to the destinations of the group(s)
  263. #   to which they belong.
  264. #   Multiple groups are possible, as long as no destination ambiguity
  265. #   results.
  266.  
  267. users:
  268.     frank:  local, d1, sm
  269.     karel:  spec, ed, local
  270.  
  271. #   The user frank is allowed to use the groups 'local', 'd1', and 'its-me'.
  272. #   So, frank can be called back at knarfix, xinix, bambix, and can also
  273. #   request a callback to wherever,using the its-me extra callback line.
  274. #   The user karel is allowed callback to 'lunatix', using the special-modem
  275. #   setting file /conf/callback/callback.2400.ttyS2, and to xinix and bambix.
  276. #   Furthermore, karel can do a direct dial-in (no callback) using the pseudo
  277. #   callback destination 'open' (being the 'destination' of 'ed'.
  278.  
  279.